home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / bbs / msrch10.zip / MULTSRCH.HLP < prev    next >
Text File  |  1996-07-01  |  11KB  |  198 lines
  1.                          MULTISEARCH TEXT DOOR HELP
  2.  
  3. The following subjects are covered in this document:
  4.  
  5. ANSI graphics files
  6. Errors you might encounter
  7. Exiting the door
  8. Going to a page
  9. How to select a file(s) to search
  10. How to search for text
  11. Finding all files containing text
  12. Moving forward and backward while searching
  13. Known problems
  14. Security to access files
  15. Single line mode
  16. Viewing an entire file with no search
  17. Downloading a document
  18.  
  19. ANSI GRAPHICS FILES
  20. If  the  file is recognized by the  file  extension (.ANS) as an ANSI graphics
  21. file  it is treated differently. It will be  searched for text, but you may or
  22. may  not  get a hit in a file of  this type because of all the embedded codes,
  23. even  if  the text you are looking for  appears in the displayed graphic. If a
  24. hit  does  occur  the  actual text of  the  file  will be displayed which will
  25. include all characters that matched the search string.
  26.  
  27. If manually selecting file(s) to view or search you will still be prompted for
  28. a  search  string,  but  the  string will  be  ignored  when  the ANSI file is
  29. processed.  Simply hit Enter to display the file.
  30.  
  31. ERRORS YOU MIGHT ENCOUNTER:
  32. There  should be very few of these. The primary one that might show up is when
  33. the  system attempts to locate a file it can't find. In this case you will see
  34. the  error  message  and  should notify the  sysop.  You  will  also get error
  35. messages describing various input errors.
  36.  
  37. EXITING THE DOOR:
  38. Very  simple;  just hit "Q" from the main  menu. The door is also carrier sen-
  39. sitive  and  will  exit  properly  when carrier  is  lost,  but  this is not a
  40. recommended practice. Most sysops will not appreciate it if you simply hang up
  41. without going through the normal board logoff procedure!!
  42.  
  43. GOING TO A PAGE:
  44. To  find  a particular page just hit "G"  when viewing or searching a file. If
  45. you  are using the graphics mode an entry box will appear in the center of the
  46. screen  to  allow  you to input the page  number  to go to. Otherwise a simple
  47. entry  prompt will be displayed. This feature is great if you haven't finished
  48. reading a document but have to end your session. Just remember the page number
  49. and  you can go straight to it during  your next session. It's also nice to be
  50. able to instantly go back to the beginning of a document.
  51.  
  52. HOW TO SELECT A FILE(S) TO SEARCH:
  53. You  have  the option of searching or viewing  any  file or files in the list,
  54. assuming  that  your  security level is  appropriately  high. To select a file
  55. simply  enter  the number of the file  you  want to search. To search multiple
  56. files  enter the number of each file,  separating each by a comma. For example
  57. if  you wish to search files 4, 5, and 6 enter 4,5,6 and hit enter. Do not use
  58. spaces or any other character to separate file numbers.
  59.  
  60. One  exception to the rule is the hyphen (-). You may specify a range of files
  61. to  search  using the first and last  file  numbers separated by a hyphen. For
  62. example, if you wanted to search files 1 through 10 enter 1-10. You cannot mix
  63. commas and hyphens, nor can you specify more than one range per search.
  64.  
  65. If  the  system is set up with more than  one page of file names you will page
  66. through  these lists with the Enter key until  you reach the menu page. If you
  67. can't  remember a file number from a previous page, hit "R" from the main menu
  68. to re-display the list of available files.
  69.  
  70. HOW TO SEARCH FOR TEXT:
  71. At the present time the door will only allow a single text string search of up
  72. to  77 characters. To search for text you  must first select one or more files
  73. to search. Once this done the text string enter prompt will be presented. Type
  74. in  the text you want, hit the enter  key, and sit back. The system will begin
  75. the  search  and display the results. If  using  the graphics mode and viewing
  76. full text (not single line mode) all search hits will be shown in white, other
  77. text  will  be green. To obtain a  "hit"  the search string must be completely
  78. contained within a single line of the file. This is because the current search
  79. algorithm scans the file a line at a time. Search strings that extend from one
  80. line  into another will not be found. For  this reason it is best to keep your
  81. search  strings  as short as possible, limiting  to  one or two key words that
  82. form a phrase.
  83.  
  84. Boolean  searches  allow  you  to use some  simple  logic  in your search. Two
  85. symbols  are  used:  "|" means "or", and  "&"  means "and". For example if you
  86. wanted  to find every line that contained  the text "you" and "me" your search
  87. string would look like this:
  88.  
  89.                                      you&me
  90.  
  91. This  would  find  every  line  in  the  document  where  those two substrings
  92. occurred.  It would also, however, find  every line containing the words "you"
  93. and  "mean". Making the search string as specific as possible will produce the
  94. best results.
  95.  
  96. To find every line where the text "you" OR "me" occurs the search string would
  97. look like this:
  98.  
  99.                                      you|me
  100.  
  101. The  search  results would show every  line containing the substrings "you" or
  102. "me". Once again, words such as "mean", "your", etc. would be found.
  103.  
  104. There  are  a  couple of other  things  concerning  these simple searches that
  105. should  be noted. First, the two different types cannot be mixed. If they are,
  106. only  the  first  operator  will be used.  For  example,  in the search string
  107. "you&me|them"  the system will recognize only  the first operator (&) and will
  108. attempt to locate every line containing "you" and "me|them", as one substring.
  109. There will not be many instances of "me|them"!
  110.  
  111. Secondly,  spaces  count.  If the search  string  contains spaces, like in the
  112. string  "you & me", the system will look for instances where "you" is followed
  113. by  a space, and "me" is preceded by a space. This can be very advantageous if
  114. it  is understood and used properly. It can also lead to inaccurate results if
  115. not kept in mind.
  116.  
  117. FINDING ALL FILES CONTAINING TEXT
  118. If  you  want to find each available  file that contains specific text use the
  119. "F"  command from the main menu. Boolean search characters are legal, but keep
  120. in  mind  that just as in a normal  document search the conditions must be met
  121. within a single line of the document. Therefore if you are searching for files
  122. containing "you&me" both "you" and "me" must be found in a single 78 character
  123. line  in  the document. You will receive  a  warning when starting this option
  124. that  the search will take some time. How  much time will depend on the number
  125. of  documents  the  sysop  has made available  and  the  speed of the machine.
  126. Remember  that  EVERY document will be  searched, and each one containing your
  127. search request will be listed.
  128.  
  129. MOVING FORWARD AND BACKWARD WHILE SEARCHING:
  130. There  will be many occasions when you will  need to backup or page forward in
  131. the  document to view surrounding text while searching. Both of these features
  132. are  available after each page of search  results has been displayed. If using
  133. the  single line mode backing up will move backwards from the last search hit.
  134. No  highlighting is done while manually moving forward or backward through the
  135. text  using either of these two features since no searching is actually taking
  136. place.  Hitting  the  Enter key at any  point  will continue the search in the
  137. forward  direction. Backing up will be slightly slower than paging forward due
  138. to  the  nature of the algorithm used  to calculate the exact distance to move
  139. back up through the file.
  140.  
  141. You  may  also  advance  a single line  at  a  time while searching. Again, no
  142. highlighting is done during this operation.
  143.  
  144. KNOWN PROBLEMS:
  145. The  door works extremely well on plain ASCII text files that contain lines of
  146. 78  characters  or  less.  Obviously  embedded  ANSI  codes,  special  control
  147. characters,  etc.  may cause a temporary  problem. The program is specifically
  148. written  to  ignore form feed characters  occurring  in text files (popular in
  149. some  program  documentation),  but  there  may  be  others  that  may  affect
  150. operation.  Also, if a line is longe